总结开发过程踩到的坑（五）（小程序篇）

最近开始接触了小程序的开发，由于时间问题，文档阅读的并不完备，也踩了很多坑。不得不说，微信的野心真是越来越大了，但是它超高的流量注定了它有这个资本。

原文地址：mini programs

---

目录

1. scroll-view 的使用
2. 关于 Swiper 的使用
3. 下拉刷新与上拉加载
4. web-view 的使用
5. 其它涉及到的内容

1. scroll-view 的使用

官方提供了 scroll-view（可滚动视图区域）组件，开发者可以很方便对其进行配置。
在使用过程中，必须要指定 scroll-view 的一个固定高度，所以在某些情况下需要动态为该组件添加高度.

//wxml
<scroll-view style="height:{{scrollHeight}}px;"></scroll-view>

//js
data: {
    scrollHeight: 500
},
onShow: function() {
    var that = this
    wx.getSystemInfo({
        success: function(res) {
            that.setData({
                scrollHeight: res.windowHeight
            })
        }
    })
}

注：使用 scroll-view 时会阻止页面回弹，所以在 scroll-view 中滚动，无法触发 onPullDownRefresh

2. 关于 Swiper 的使用

官方同样提供了 swiper 组件，只需简单进行配置即可实现轮播图，但是对于轮播图的指示点来说，并没有提供过多的配置，所以若要修改指示点，需要禁用默认自行进行模拟。

//wxml
<swiper class='swiper' autoplay circular interval='2000' bindchange="swiperChange">
    <swiper-item>
        <image src="{{imageUrl}}"/>
    </swiper-item>
</swiper>
<view class="dots">     
    <block wx:for="{{imgUrls}}"> 
      <view class="dot{{index == swiperCurrent ? ' active' : ''}}"></view> 
    </block> 
</view>

//js
data: {
    swiperCurrent : 0
},
swiperChange: function (e) {
    this.setData({
      swiperCurrent: e.detail.current
    })
},

3.下拉刷新与上拉加载

在小程序中，官方为我们提供了原生的下拉刷新和上拉加载，只需要进行简单的配置即可实现下拉刷新的功能

//app.json
"window": {
    "backgroundTextStyle": "dark",//如果下拉未呈现加载中图标，将 light 改为 dark
    "enablePullDownRefresh": true,
    "onReachBottomDistance": 50//页面上拉触底事件触发时距页面底部距离，单位为px
    }
    
//js
onPullDownRefresh: function() {
    //标题显示加载 gif
    wx.showNavigationBarLoading()
    //执行完成后，停止下拉刷新和加载 gif
    wx.stopPullDownRefresh()
    wx.hideNavigationBarLoading()
}，
onReachBottom: function() {
    //your code
    
}

除此之外，还可以使用 scroll-view 组件来实现这两个功能

//wxml
<scroll-view style="height: {{scrollHeight}}px;" enable-back-to-top bindscrolltolower="loadMore" bindscrolltoupper="refreshData">
</scroll-view>

//js
loadMore: function() {
    //your code
},
refreshData: function() {
    //your code
}

在实际体验中，使用 scroll-view 的下拉刷新，当页面处于最顶端时，下拉无法触发该事件，需要滚动页面一段距离再下拉才会触发 bindscrolltoupper，体验并不友好，所以还是建议使用小程序原生下拉刷新。

另一个问题是，在上拉加载的时候，经常会触发多次加载事件，显然是不符合需求的，解决方法可以为加载事件添加一个加载状态，默认 true，触发加载时置为 false，待事件全部执行完毕后再修改为 true。

//wxml
<scroll-view style="height: {{scrollHeight}}px;" enable-back-to-top bindscrolltolower="{{loadMore? 'loadMore' : ''}}">

</scroll-view>

4. web-view 的使用

微信小程序不支持原生页面跳转，包括 html 和 js，若要跳转小程序应用内页面，需要使用 wx.navigateTo(OBJECT)，详见 wx.navigateTo API。若要跳转 H5 页面，就需要用到 web-view 组件了。
web-view 组件是一个可以用来承载网页的容器，会自动铺满整个小程序页面。

<web-view src="{{url}}"></web-view>

web-view指向的 H5 链接必须要在小程序后台配置白名单。

若要实现动态跳转，只需要动态传参到 web-view 所在页面就可以了

//demo.wxml
<view class='search-right' data-url='{{url}}' bindtap='toPage'></view>

//demo.js
data: {
    url: 'https://www.google.com'
},
toPage: function(e) {
    wx.navigateTo({
        url: 'pages/webView?url=' + e.currentTarget.dataset.url
    })
}

//webView.wxml
<web-view src="{{url}}"></web-view>

//webView.js
data: {
    url: ''
},
onLoad: function(options) {
    options.url? this.setData({ url: options.url }) : wx.navigateBack()
}

5. 其它涉及到的内容

小程序不能使用层级选择器。
在 wxss 不能使用背景图片，需要使用 image 组件引入图片。
wxml中不能直接插入转义字符，需要使用在 text 组件中使用。

<text decode="{{true}}" space="{{true}}">&nbsp;&nbsp;</text>

自定义循环变量使用 wx:for-item="i"。

参考文献

微信小程序开发者文档